Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Functions / Creating and Manipulating Format Objects

GXCountFormatOwners

You can use the GXCountFormatOwners function to determine the owner count of a format object.

long GXCountFormatOwners (gxFormat aFormat);

aFormat

A reference to the format object in which to obtain the owner count.

function result

The owner count.

DESCRIPTION

The GXCountFormatOwners function returns the current number of references to the format object specified by the aFormat parameter. The GXNewFormat function sets the owner count to 1. The GXCloneFormat function increments the owner count of a format object by 1, and the GXDisposeFormat function decrements the owner count by 1. When the owner count reaches 0, QuickDraw GX disposes of the format object.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

The GXNewFormat function, which creates a new format object with an owner count of 1, is described on page 3-104.

The GXCloneFormat function, which increments the owner count of a format object by 1, is described on page 3-106.

The GXDisposeFormat function for decrementing the owner count of a format object by 1 is described on page 3-104.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help